home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / exampleCode / video / seqgrab / README < prev    next >
Encoding:
Text File  |  1994-08-02  |  2.2 KB  |  72 lines
  1.  
  2.             ~4Dgifts/toolbox/src/exampleCode/video/seqgrab README
  3.  
  4.  
  5.                             02.12.94
  6.  
  7. seqgrab - sequential frame accurate grabbing on Galileo w/hw trigger
  8.  
  9. Grabs a sequence of frames between start and end timecodes.  This
  10. works on a very specific configuration of equipment, namely a
  11. system with a Galileo video board, a frame accurate device and a
  12. VLAN controller.
  13.  
  14. seqgrab: -i <start SMPTE tc> -o <end SMPTE tc> [-f <filename>]
  15.                 [-w] [-d] [-s w h] [-n <device>] [-v <videonode> ]
  16.                 [-c <num>] [-r] [-t] [-z n/d] [-O <frames>] [-D] [-h]
  17.  
  18.         -i    starting <SMPTE timecode> to grab frames
  19.         SMPTE timecode format is hours:minutes:seconds:frame 
  20.         HH:MM:SS:FF
  21.             * all fields are required 
  22.           i.e.  00:00:01:02 to get frame 2 of minute 1
  23.  
  24.         -o     ending <SMPTE timecode> to grab frames
  25.  
  26.         -f      output filename
  27.         this is the base name of the filenames created. The rest of 
  28.         the filename is composed of a frame number and an extension
  29.         which represents the video data format of the file 
  30.         e.g. filename of /usr/tmp/doodah  produces frames 
  31.         /usr/tmp/doodah-00000.rgb
  32.  
  33.         -w      don't write frame to disk
  34.  
  35.         -d      display captured frame
  36.         puts capture frames up in ipaste windows.
  37.  
  38.         -s w h  frame dimensions (must be last option if specified)
  39.  
  40.         -c num  number of frames to capture
  41.         sequentially while the device is playing.  Currently the 
  42.         default is set to the size of the Galileo internal buffer 
  43.         size which is 3 frames.
  44.  
  45.         -n device       device number to use
  46.  
  47.         -r      raw mode output (no YUV->RGB or de-interlace)
  48.  
  49.         -v      video source node number
  50.  
  51.         -z      zoom the image by n/d
  52.  
  53.         -O      offset # frames from starting timecode (default = -1)
  54.         to adjust for timing delays between when the trigger is set
  55.         to when the VL is able to respond.  This is seen as a very
  56.         regular interval.
  57.  
  58.         -p      preroll time <SMPTE timecode> (default 5 sec.)
  59.  
  60.         -V      verbose
  61.  
  62.         -h      this help message
  63.  
  64.  
  65. See captureconfig.showcase file which contains a diagram of the
  66. equipment configuration setup.
  67.  
  68. NOTE: 
  69.  
  70. Currently the mapping of SMPTE start and endpoints does not work with
  71. framedrop timecode so you may not get exactly what you want.
  72.